home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1997 August / Macworld (1997-08).dmg / Serious Demos / Crimson Demo / Crimson Basic Manual / Crimson Basic Manual.rsrc / TEXT_1300_Properties, Methods and Events.txt < prev    next >
Text File  |  1997-06-17  |  4KB  |  66 lines
  1.     
  2. Properties,Methods and Events
  3. What are they ?
  4. The buzzwords Properties, Methods and Events owe their origins largely to Object Oriented methodologies and technologies. Crimson Basic is designed to avoid the complexities of Object Oriented methods, however, the GUI controls used are implemented as objects and therefore these terms are used to describe the way in which the programmer interacts with GUI controls.
  5.  
  6. Properties    
  7. Properties are a way of storing information about a particular instance of a control, for example, a Button control may appear many times within a form, but each Button has distinct characteristics (properties) depending upon how the programmer wishes the button to be used. One Button on a form may be Visible whereas another may be Invisible. Therefore 'Visible' is a property of Button. Properties are effectively variables which exist in their own right for each control.
  8.  
  9. Properties are Set and retrieved using the following format :
  10.  
  11. Formname.Controlname.Property
  12.  
  13. Examples of the Setting and Getting of Properties are :
  14.  
  15. MyForm.Button1.Enabled=True
  16. (Sets the Enabled Property on Control Button1 on Form MyForm to True. The button will now respond to mouse clicks etc.)
  17.  
  18. X=Myform.Button1.Visible
  19. (X is set to the True/False value of the Visible Property of Button1 on Myform.)
  20.  
  21. MyForm.EText.Value="Hello"
  22. (Sets the Value of the text in the Editable Text field named EText on the Form MyForm to "Hello")
  23.  
  24. Methods    
  25. A Method is very much like a subroutine except that it relates to a particular instance of a Control. Methods are used to perform operations on Controls which cannot be performed by simply setting Properties, such as :
  26.  
  27. Form1.OpenWindow()
  28. (Opens the Window named Form1 [this is the name you gave it when you designed it] and displays it [if the Visible Property is set to True])
  29.  
  30. Form1.ShowWindow()
  31. (Makes the Form Form1 visible on the screen if it was invisible. In this case, calling the ShowWindow method is equivalent to setting the Forms Visible Property to True).
  32.  
  33. X=MyForm.MyListBox.GetRow(2)
  34. (Sets the String X to the value stored in the second row within the ListBox MyListBox on the Form MyForm.
  35.  
  36. MyForm.MyListBox.InsertRow(2,"Pot Noodle")
  37.  (Inserts a row in the ListBox MyListBox, after row 2, containing the string "Pot Noodle").
  38.  
  39. Events    
  40. An Event is something which occurs due to a user of the program using the mouse or pressing a key in some way. These Events are reported to the program as calls to Procedures which are coded by the programmer. For example, If the Form Form1 contains a Button named Button1 the following procedure will be called every time the user Clicks on that particular button.
  41.  
  42.     Procedure Form1.Button1.Click()
  43.         ......
  44.         ......
  45.     Return
  46.  
  47. Other user events may be processed in the same way :
  48.  
  49.     Procedure Form1.OnMenu(MenuId,MenuItem)
  50.     Parameter MenuId As Integer
  51.     Parameter MenuItem As Integer
  52.         .....
  53.         .....
  54.     Return
  55.  
  56. (This procedure will be called every time the user selects a menu item whilst this form is active [the one in front]. The MenuId and MenuItem relate to the numbers which were supplied when the menus were created).
  57.  
  58.     Procedure MyForm.Rect1.MouseDown(XPos,YPos)
  59.     Parameter XPos As Integer
  60.     Parameter YPos As Integer
  61.         ......
  62.         ......
  63.     Return
  64.  
  65. (This procedure will be called every time the user depresses the mouse whilst it is within the Rectangle named Rect1 on MyForm. The Xpos and YPos parameters contain the Horizontal and Vertical position of the mouse (in pixels) within the Rectangle at the time the mouse button was pressed.
  66.